Inside Macintosh: QuickTime Components /

Chapter 8 - Video Digitizer Components / Video Digitizer Components Reference

Video Digitizer Component Functions / Setting Source Characteristics

VDGetActiveSrcRect

The VDGetActiveSrcRect function allows applications to obtain the size and location information for the active source rectangle used by a video digitizer component.

pascal VideoDigitizerError VDGetActiveSrcRect
                                  (VideoDigitizerComponent ci,
                                    short inputStd,
                                    Rect *activeSrcRect);

ci

Specifies the video digitizer component for the request. Applications obtain this reference from the Component Manager's OpenComponent function.

inputStd

A short integer that specifies the input video signal associated with this maximum source rectangle.

activeSrcRect

Contains a pointer to a rectangle that is to receive the size and location information for the active source rectangle.

DESCRIPTION

The source rectangle is that area in the source video image that contains active
video. The video digitizer component returns spatial information that is relative to the maximum source rectangle. For a complete discussion of the relationship between these rectangles, see "About Video Digitizer Components," which begins on page 8-3.

All video digitizer components must support this function.

RESULT CODES

noErr	0	No error
qtParamErr	-2202	Invalid parameter value

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help